home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu295.dms / pu295.adf / Logging / VhfLog / VHFLOG.DOC < prev    next >
Text File  |  1988-12-18  |  4KB  |  97 lines
  1. VHFLOG.BAS
  2. Original program by Clarke Greene K1JX
  3. Amiga version by John Gager K7KB
  4.  
  5. [See bug report at end of this file.]
  6.  
  7. This ARC file contains the Microsoft BASIC (tm) source code for the ARRL VHF
  8. Contest log editing program listed in the "Contests" chapter of The ARRL
  9. Operating Manual, Third Edition.  The program takes an ASCII log listing (as
  10. created by you with your favorite word processor), and produces a log package
  11. suitable for submission to the contest sponsor.  Three separate files are 
  12. produced:
  13.  
  14.     1. A LOG file - (identified by the filename extension ".LOG").  This file
  15.        holds the actual log. New multipliers are identified and counted, and
  16.        duplicate contacts identified.
  17.  
  18.     2. A DUPE SHEET file - (identified by the filename extension ".DUP"). This
  19.        file holds a dupe sheet as required by the contest sponsors.  This is a
  20.        complete listing of all the contacts made on a particular band, in
  21.        alphabetical order.
  22.  
  23.     3. A SUMMARY file - (identified by the filename extension ".SUM"). This
  24.        file holds a summary sheet for the band edited. Total valid QSOs,
  25.        duplicate QSOs, and grid squares worked are listed, as well as a
  26.        complete breakdown of QSOs per grid square.
  27.        
  28. The file containing the log entries must be an ASCII file in the 
  29. following format:
  30.  
  31.     TIME      CALLSIGN      RCV'D REPORT
  32.  
  33. At least one space must be between each field of each log entry, and each line
  34. must be terminated by a carriage return. Only a changed digit in the time
  35. field must be present; for example, if the contest begins at 1800Z and the
  36. first contact is made at 1802Z and the second contact is made at 1805Z, then
  37. only 5 need be entered in the time field. If the third contact is made at 
  38. 1812Z, then 12 should be entered in the time field. If the next contact is
  39. made at 1812Z, then no number need be entered in the time field (however, be
  40. sure to enter a space to indicate separation between fields).
  41.  
  42. The three output files (.LOG, .DUP, and .SUM files) can be printed by using
  43. the Amiga "TYPE" command.
  44.  
  45. Some reminders:
  46.  
  47. 1. Be sure your log is in an ASCII format. Just about every word processor can
  48.    operate in an ASCII or Non-Document mode - that should work fine.  As an
  49.    alternative, you can use one of the many utilities available in the
  50.    marketplace and in the public domain to convert your word processor output
  51.    into an ASCII format.
  52.  
  53. 2. If you enter the callsigns in your log in lowercase, they are automatically
  54.    converted to uppercase for the final .LOG file.
  55.  
  56. 3. Each band requires a separate entry file. The output files will be named as
  57.    the original filname plus the appropriate extension (for example
  58.    JUNE144.LOG, JUNE144.DUP, and  JUNE144.SUM would be produced from the log
  59.    entry file JUNE144).  As a consequence of this, any file with the same name
  60.    will be overwritten when VHFLOG is run. To avoid any deletion of valid
  61.    files, use unique names for the files used on each band, and don't use the
  62.    extensions .LOG, .DUP, or .SUM.
  63.  
  64. Special notes for the Amiga version
  65. -----------------------------------
  66.  
  67. This ARC contains 3 files:
  68.  
  69. VHFLOG.BAS - AmigaBasic program
  70.  
  71. VHFLOG.DOC - This documentation file
  72.  
  73. VHFLOG.DAT - A small log file used to show example log entrys and to test the
  74.              VHFLOG.BAS program.
  75.  
  76.   To give credit where credit is due, this program is by Clarke Greene K1JX.
  77. The only thing I've done is go through his program and make it more agreeable
  78. with AmigaBasic, and add a few minor features along the way. I really haven't
  79. had a chance to test this program throughly since I don't get into contesting
  80. very much, but I believe it is free of any major bugs. If you find any bugs
  81. that I have missed, or have suggestions and comments about these programs,
  82. please let me know.
  83.  
  84. 73,
  85.  
  86. John Gager K7KB
  87. Compuserve ID 71336,624
  88.  
  89. Amiga features include:
  90.  
  91.  * Automatic capitalizing of entries read from log source file.
  92.  
  93.  * Automatic capitalizing of keyboard entries from program prompts.
  94.  
  95.  * Expanded error checking for improper data read both from the log
  96.    source file and the keyboard.
  97.